home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat1 / mkaf.z / mkaf
Text File  |  1997-04-03  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. MMMMKKKKAAAAFFFF((((1111))))                                                                MMMMKKKKAAAAFFFF((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mmmmkkkkaaaaffff - create a Performance Co-Pilot archive folio
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////ppppccccpppp////bbbbiiiinnnn////mmmmkkkkaaaaffff _f_i_l_e_n_a_m_e ...
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      A collection of one or more Performance Co-Pilot (PCP) archive logs may
  16.      be combined with mmmmkkkkaaaaffff to produce a PCP archive folio and the associated
  17.      archive folio control file.  Certain other PCP tools use mmmmkkkkaaaaffff to create
  18.      archive folios, e.g.  the ``record'' facility in the ppppmmmmcccchhhhaaaarrrrtttt(1) tool
  19.      creates PCP archive folios.
  20.  
  21.      Once created, the archive folio may be processed using ppppmmmmaaaaffffmmmm(1).
  22.  
  23.      mmmmkkkkaaaaffff processes each _f_i_l_e_n_a_m_e argument, and if this is a component file
  24.      from a PCP archive that archive is added to the folio.
  25.  
  26.      If _f_i_l_e_n_a_m_e is a directory, then this is searched recursively using
  27.      ffffiiiinnnndddd(1).  Any _f_i_l_e_n_a_m_e argument beginning with a ``-'' is assumed to be a
  28.      ffffiiiinnnndddd(1) command line option; the default is ----ffffoooolllllllloooowwww.
  29.  
  30.      The folio control file is written to standard output, and has the
  31.      following format.
  32.  
  33.      1. The first line contains the word PPPPCCCCPPPPFFFFoooolllliiiioooo.
  34.  
  35.      2. The second line contains the tag VVVVeeeerrrrssssiiiioooonnnn:::: followed by the format
  36.         version number (currently 1).
  37.  
  38.      3. For subsequent lines, blank lines and lines beginning with ``#'' are
  39.         ignored.
  40.  
  41.      4. The line beginning with the tag CCCCrrrreeeeaaaatttteeeedddd:::: documents where and when the
  42.         folio was created.
  43.  
  44.      5. The line beginning with the tag CCCCrrrreeeeaaaattttoooorrrr:::: identifies the tool which
  45.         created the folio.  If present, the second argument is the name of a
  46.         configuration file that the creator tool could use to replay the
  47.         archive folio, e.g. with the rrrreeeeppppllllaaaayyyy command for ppppmmmmaaaaffffmmmm(1).
  48.  
  49.      6. Then follow one or more lines beginning with the tag AAAArrrrcccchhhhiiiivvvveeee:::: and
  50.         followed by the hostname and base name of the archive.
  51.  
  52.      For example
  53.           $ mkaf /var/adm/pcplog/gonzo
  54.      might produce the following folio control file.
  55.  
  56.      PCPFolio
  57.      Version: 1
  58.      # use pmafm(1) to process this PCP archive folio
  59.      #
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MMMMKKKKAAAAFFFF((((1111))))                                                                MMMMKKKKAAAAFFFF((((1111))))
  71.  
  72.  
  73.  
  74.      Created: on gonzo at Tue Jul  2 03:35:54 EST 1996
  75.      Creator: mkaf
  76.      #               Host                    Basename
  77.      #
  78.      Archive:        gonzo                   /var/adm/pcplog/gonzo/960627
  79.      Archive:        gonzo                   /var/adm/pcplog/gonzo/960628
  80.      Archive:        gonzo                   /var/adm/pcplog/gonzo/960629
  81.      Archive:        gonzo                   /var/adm/pcplog/gonzo/960630
  82.      Archive:        gonzo                   /var/adm/pcplog/gonzo/960701
  83.      Archive:        gonzo                   /var/adm/pcplog/gonzo/960701.00.10
  84.      Archive:        gonzo                   /var/adm/pcplog/gonzo/960701.05.25
  85.      Archive:        gonzo                   /var/adm/pcplog/gonzo/960702.00.10
  86.  
  87. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  88.      ffffiiiinnnndddd(1), ppppmmmmaaaaffffmmmm(1) and ppppmmmmcccchhhhaaaarrrrtttt(1).
  89.  
  90. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  91.      Some informational messages, warnings and pathological conditions are
  92.      reported on standard error.
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.